Skip to main content

selectedLine

Type​

function

Summary​

Returns a chunk expression describing the line or lines in the text selection.

Syntax​

the selectedLine
selectedLine()

Description​

Use the selectedLine function to determine which line the selection or text insertion point is in.

A line is defined as a string that's delimited by return characters. A line in a narrow field may wrap around several times, and look like more than one line on screen, but it is still considered a single line.

If there is no insertion point or text selection, the selectedLine function returns empty.

To get a chunk expression describing the location of the selection, use the selectedChunk function. To get the selected lines in a list field that allows non-contiguous selections, use the hilitedLine property.

Examples​

the selectedLine
select the selectedLine

Value​

NameTypeDescription

return

The selectedLine function returns a chunk expression of the form line lineNumber of field fieldNumber if the text selection is on one line, or

    line startLine to endLine of field fieldNumber

if the text selection crosses multiple lines.

keyword: selection, line, lines

property: selected, hilitedLine

control structure: function

function: selectedLoc, selectedChunk, mouseLine

glossary: property, insertion point, list field, contiguous, return, chunk expression

Compatibility and Support​

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile

Thank you for your feedback!

Was this page helpful?